home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / boot / KBD.lha / KBD.doc next >
Encoding:
Text File  |  1995-04-09  |  2.2 KB  |  63 lines
  1. KBD executes a script at shutdown time.
  2. Requirements: Execute in C: directory, and S:KBD.script (see text)
  3. Written in assembly language only.
  4.  
  5. You can think of KBD as a switch. Run it once, and the resethandler
  6. is installed. Run it again, and the resethandler is removed.
  7.  
  8. Usage:
  9.  
  10. Run >NIL: KBD    ; installs KBD
  11. KBD        ; removes KBD
  12.  
  13. KBD installs a resethandler, which executes a user-supplied
  14. script when the user presses Ctrl-Amiga-Amiga.
  15. KBD needs this script as S:KBD.script, and it needs Execute
  16. in C:.
  17.  
  18. To install, KBD should be _run_ (from shell), it doesn't
  19. detach by itself. You can remove KBD by sending Ctrl-C to it,
  20. or by just executing it again ( just 'KBD', no need to run it).
  21. This is because KBD installs its own messageport, which
  22. it looks for when it's started. If it finds a port, it just
  23. sends a Ctrl-C to this port.
  24.  
  25. KBD is not yet allowed to run from Workbench ( Don't attach
  26. an icon to it )
  27.  
  28. KBD uses the fact that when you press Ctrl-Amiga-Amiga,
  29. keyboard.device calls installed reset-handlers and lets
  30. them execute code before the machine goes to reset. 
  31. When KBD's handler is called, it signals the parent
  32. process, which executes the script in S:KBD.script,
  33. and uninstalls the resethandler when the script is done,
  34. allowing keyboard.device to continue with the shutdown.
  35. Please don't waste in this script. Note that the Amiga will
  36. reset after 10 seconds anyway.
  37. Note also: The keyboard stops responding after you press C-a-a,
  38. so you can't type anything.
  39.  
  40. Tested and found working on the following machines:
  41. A4000/040(w/mufs), A1200/020(wo/mufs), A1200/030/50Hmz(w/mufs).
  42. No problems experienced. No known bugs. Not tested from
  43. Workbench (I _know_ it will crash, though)
  44.  
  45. Tested and found NOT working on:
  46. A500.
  47.  
  48. NOT tested on:
  49. A1000, A2000, A3000 and other Amigas.  I would like to hear
  50. from people who have these machines (email address below)
  51.  
  52.  
  53. KBD is freeware. If you re-distribute this archive, please
  54. keep it intact.
  55. Source is not included, but the code is based upon the
  56. keyboard.device example code in RKM:libs/devs 2.ed.
  57.  
  58. My email address is skrsmoen@nvg.unit.no, if you wonder
  59. about anything, find any bugs, have any complaints or 
  60. suggestion, want to see the source, or just want to talk.
  61.  
  62. Rune
  63.